home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / zflash.lzh / ZFLASH.DOC < prev    next >
Text File  |  1991-11-12  |  9KB  |  222 lines
  1.  
  2.  
  3.  
  4.  
  5.   *************    _______________________________________________
  6.            ***   __       __        ________  ________  __    __
  7.          ***   _______  __        __    __  __        __    __
  8.        ***   __       __        ________  ________  ________
  9.      ***   __       __        __    __        __  __    __
  10.    ***   __       ________  __    __  ________  __    __
  11.  ***
  12. ***************************************************************
  13.  
  14.                Zmodem Transfer Shell v1.20 for
  15.  
  16.                     Flash v.1.50 upwards
  17.  
  18.               (c) 1988 by DeltaVision Systems
  19.  
  20.                      Written by J. Webb
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. ---------------------------------------------------------------------
  31.                             What is Zmodem?
  32. ---------------------------------------------------------------------
  33.  
  34.         Zmodem is a fairly new transfer protocol. It has a lot of 
  35. features which other protocols don't have...
  36.  
  37.      1) It's MUCH faster than Xmodem or Ymodem. Tests show an average
  38.         throughput of more than 90%. Transfer of large files might
  39.         even reach 98 or 99%. Compare that to standard Xmodem (approx.
  40.         60%), Ymodem (70%), and that's if you have a GOOD connection.
  41.  
  42.      2) Zmodem has a variable block size (they're called 'packets' in
  43.         Zmodem). This means it will reduce the size of each packet if
  44.         a lot of errors occur. If, say, with Xmodem-1K an error occurs,
  45.         the whole Kb must be resent. If this happens with Zmodem, it
  46.         will reduce the size of the packets, so that if another error
  47.         occurs it won't have to send TOO much again.
  48.  
  49.      3) Xmodem and Ymodem use either Checksum (8-bit) or CRC (16-bit)
  50.         error checking. Zmodem however uses 32-bit CRC, which improves
  51.         the reliability of the protocol.
  52.  
  53.      4) If, say, during a transfer the carrier is lost, Zmodem can
  54.         resume the transfer from the point where it went wrong. Very
  55.         nice if you're transfering large files.
  56.  
  57.      5) Zmodem is a batch protocol, which means you can transfer more
  58.         than one file at once.
  59.  
  60.         These are just a few of the Zmodem features. There are a lot more,
  61. but these are the most important and handy. If the BBS system supports
  62. Zmodem, use it!
  63.  
  64. --------------------------------------------------------------------------
  65.                                 What is ZFlash?
  66. --------------------------------------------------------------------------
  67.  
  68.         For some reason or other the authors of the main comms packages on
  69. the ST are too lazy to implement new protocols. In the PC world a comms
  70. package without Zmodem, or without the ability to use an external protocol
  71. (like in Procomm Plus) isn't taken seriously. It's about time people using
  72. an ST start thinking this way.
  73.  
  74.         Flash is one of those programs. One of the best, I think, but it
  75. doesn't support anything faster than Ymodem Batch. I had some Zmodem
  76. sources, and decided to get them to work as stand-alone receive and
  77. transmit modules. To control the two .TTP programs, I thought it would be
  78. handy to have a shell which could be executed from within Flash. That's
  79. what ZFlash is all about. It has a small terminal emulator, Zmodem Send
  80. and Zmodem Receive.
  81.  
  82. --------------------------------------------------------------------------
  83.                         How to Install ZFlash
  84. --------------------------------------------------------------------------
  85.  
  86.         I assume you've unARCed the ZF110.ARC file, otherwise you wouldn't
  87. be reading this now. Place the files from the ARC in a directory, doesn't
  88. matter which. Now edit the file ZFLASH.CFG. This is a little configuration
  89. file, and contains your default DOWNload directory and UPload directory,
  90. in that order. It also contains some preferences, and looks like:
  91.  
  92.         Download Directory
  93.         Upload Directory
  94.         Use Gem?
  95.         BBS Mode?
  96.         Protect Files?
  97.         Sound On?
  98.  
  99. An example would be:
  100.  
  101.         d:\comms\download\
  102.         c:\upload\
  103.         1
  104.         0
  105.         1
  106.         1
  107.  
  108. 'Use Gem' defines whether ZFlash defaults to file selector mode or not. If
  109. you want to use a file selector instead of the command line, but have set
  110. Gem mode off, enter a '?' as the first character of the line.
  111.  
  112. 'BBS Mode' is something I built in for Sysops. If you've downloaded a file
  113. ZFlash will ask for a description, and add the file to FILES.BBS. If you
  114. enter a blank description, the file will not be added.
  115.  
  116. 'Protect Files' defines whether ZFlash must protect files with the same
  117. name. If - say - you have a file called MYFILE.ARC, and the other side
  118. starts sending a file with the same name, ZFlash would either abort or
  119. overwrite the file.
  120.  
  121. 'Sound On' is for if you don't like the beeps which ZFlash gives on
  122. completion of the transfer.
  123.  
  124. By the way, ZFLASH.CFG can be either in the default (current) directory,
  125. or in the directory to which environment variable FLASH points (for people
  126. who use a command line interpreter).
  127.  
  128. ---------------------------------------------------------------------------
  129.                      Using ZFlash from ... FLASH!
  130. ---------------------------------------------------------------------------
  131.  
  132.         Next, load Flash, and select 'Edit Function Keys'. Choose an empty
  133. key, and enter the following line:
  134.  
  135.         >GEM [zflash program]|
  136.  
  137. where [zflash program] is the path and name of Zflash, i.e.
  138.  
  139.        >GEM d:\comms\flash\zflash.prg|
  140.  
  141. Don't forget the vertical bar at the end! Save your function keys, and
  142. press the key you've just defined. You should get the ZFlash menu.
  143.  
  144. ---------------------------------------------------------------------------
  145.                               Using ZFlash
  146. ---------------------------------------------------------------------------
  147.  
  148. The menu looks something like this:
  149.  
  150.                 [R] ......... Receive Zmodem
  151.                 [S] ............ Send Zmodem
  152.                 [T] ...... Terminal Emulator
  153.                 [Q] ................... Quit
  154.  
  155. Pressing 'Q', 'ESC' or 'UNDO' will take you back to Flash. Pressing 'T'
  156. gets you in the terminal emulator (for last minute stuff), 'Undo' returns
  157. to the menu when you're in the emulator.
  158.  
  159. [R] starts up the Zmodem Receiver. It will ask you for the directory where
  160. your downloads should be placed. Enter a '?' as the first character if you'd
  161. like to use a file selector instead of typing. The directory must exist, to
  162. abort enter an empty line, or ESC.
  163.  
  164. [S] is for Sending one or more files. Wildcards are supported. Again,
  165. press '?' to get a file selector.
  166.  
  167. You can also use the cursor key to move the highlight, and press Return to
  168. choose an option.
  169.  
  170. ---------------------------------------------------------------------------
  171.                              Standard Disclaimer
  172. ---------------------------------------------------------------------------
  173.  
  174. I can not be held responsible for any damages which might occur due to the
  175. use of ZFlash. If you use any of the files in the package, it's entirely at
  176. your own risk. You might turn your 80 Mb harddisk into a 360 floppy, hey,
  177. I'll probably try to sell you another one...
  178.  
  179. ---------------------------------------------------------------------------
  180.                             Sources & Copyrights
  181. ---------------------------------------------------------------------------
  182.  
  183. The Zmodem sources used were in a package called ZMDM.ARC which I found
  184. somewhere. I think they were ported by a group who call themselves 'ST
  185. Enthusiasts at Case Western Reserve University'. They were rather buggy,
  186. I hope I fixed quite a few 'undocumented features'.
  187.  
  188. Zmodem and probably Ymodem are Copyrights of Chuck Forsberg, Omen
  189. Technologym, and are quite likely to be trademarks too...
  190.  
  191. Flash is Copyrighted by Antic Publishing.
  192.  
  193. ZFlash may be distributed freely as long as you stick to the following
  194. rules:
  195.  
  196.          1) You do NOT charge ANYTHING for the package
  197.          2) You distribute the complete package, including this document
  198.          3) You may post ZFlash on a BBS as long as all users may d